| Name: | <<>> - Create a new dictionary.
|
| Synopsis: | << /key1 val1 ... /keyn valn >> -> dict
|
| Parameters: | /key - literal name
val - Object of any type
|
| Description: | Constructs a dictionary with the entries which are specified
by key-value pairs.
Note that the key-value pairs are evaluated BEFORE the dictionary is
constructed.
<< >> operates the following way:
The characters << correspond to a mark which is pushed on the stack.
Next, all following key-value pairs are evaluated.
>> finally counts the number of pairs on the stack and constructs a
new dictionary.
|
| Examples: |
SLI ] << /a 1 /b 2 >> info
--------------------------------------------------
Name Type Value
--------------------------------------------------
a integertype 1
b integertype 2
--------------------------------------------------
Total number of entries: 2
SLI ] << (a) (b) join cvlit 2 3 mul 2 add >> info
--------------------------------------------------
Name Type Value
--------------------------------------------------
ab integertype 8
--------------------------------------------------
Total number of entries: 1
|
| Diagnostics: | An ArgumentType error is raised if the
initializer list does not consist of proper /key value
pairs.
|
| References: | The Red Book
| SeeAlso: | clonedict begin cleardictstack dict dictstack info end |
|
| Source: | /home/abuild/rpmbuild/BUILD/nest-2.4.1/sli/slidict.cc
|